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PRELIMINARY OPERATING INSTRUCTIONS FOR MACfiO III 

MACRO III is an assembly program for the TX-0 Computer* It will 
assemblo any program that MACHO IIA will assemble, and in addition has 
various new features of its own* It is assumed that the reader is familiar 
with the memos MACRO IIA (M-5OOI-5-I) and Relocatable Programming for the 
TX-0 (M -5001-3** )<> 

In addition to those recognized by MACRO IIA 6 MACRO III recognizes 
the following pseudo-instructions: repea$ . variables „ relocatable » entry ,, 
exit* frontloadin^ro and readin e The new features can be described largely 
in terms of these pseudo-instructions* 

repeat n„x causes the quantity jc to be inserted in the program n, 
times* XL must have a definite value at its appearance on Pass l c and cannot 
be an argument of a macro-instruction- x consists of everything between the 
comma and the next carriage return, and may consist of any words parameter 
assignments, macro-instructions, etc, that are legal elsewhere except the 
pseudo- instruct ions repeat . text , and start o A tab may be substituted for 
the commao If n. is zero, x will be ignored* n. may not be negative* Al- 
though legal, the pseudo-instructions define , terminate , constants , variables , 
readin . and frontloadin^ are not meaningful within the range of a repeat « 

Variables are symbolic syllables not otherwise defined which have 
at least one letter in upper case at their first appearance in the program* 
Succeeding appearances of a variable may, but need not, have a letter or 
letters in upper case. At the pseudo-instruction variables „ a block of 
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etorage of length aq.ua! to the number of distinct variables preceding it 
is reservede On paso 2 6 the variables will be assigned values of consecu- 
tive locations in the variables storage in the order of their appearance * 
Thus it is not necessary explicitly to reserve temporary storage registers 
in the program* Variables used in a macro-instruction definition cannot be 
defined in the definition and therefore must be defined before ito If de~ 
sired this can be done by using the variable in the right-hand side of a 
parameter assignment before the macro-instruction definition, Note that at 
the end of Pass 1„ all variables are defined as -0* The correct value is 
assigned during Pass 2* 

frontloading if used must be the first thing on the English tape* 
It causes a front input routine using registers 1-37 to be prepared,, and 
sets the location to kQ* (& select must be on when the program is read in, 
readin suppresses the input routine entirely. The entire program 
is punched in read-in modeo 

relocatable sets the location to -relocatable 0. The program will 
be assembled in relocatable format until a location assignment is encountered 
whose relocation count is 0. A location assignment with relocation count 
of +1 will cause MACfiO to enter or remain in relocatable mode- The input 
routine is replaced with a one-word transfer instruction tra 17000 n which 
transfers control to the Binary fielocatable Subroutine Loader* Address tags 
are defined relocatable or absolute as the current mode is relocatable or 

absolute. Symbols defined by parameter assignment will have a relocation 
count equal to that of the word on the right-hand side of the equals sign 
except that no symbol can have a relocation count exceeding 1 in magnitude „ 
Storage words in relocatable mode may have relocation +1 6 ~l e or 0; words 
in absolute mode may have relocation only*. Words in macro-instruction 
definitions may acquire any relocation so long as the final storage word® 
assembled have relocation as specified above a 
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entry and exit are used to produce the program card and transfer 
vector, respectively o The usage is entry sl n s2 n , . v en where the symbols 
sl etc* are addresses in the program to which other programs may transfer 
control; and exit sl fl s2„ . . . »sn where the symbols sjl^ etc* are the names 
of other programs or subroutines to which control is to be transferredo 
The arguments of entry must be defined elsewhere in the program,, while the 
arguments of exit are defined as addresses in the transfer vector by this 
use and must nofr be defined elsewhere* Secondary entries to a program are 
defined by a second appearance of entry immediately after the firsts To 
the extent that the pseudo-instructions relocatable . enftry„ and exit, are 
used they must be used in that order „ and no storage words may intervene 
between them* A program with no entry is a main program, and the pseudo- 
instruction exfl,t will cause the program card to be punched with a name of 
+0 as required by the loader o If neither entry nor exit is used no pro~ 
gram card will be provided o Since any program to be loaded by the BRS 
Loader must have a program card it has been made possible to get a program 
card with a main program entry by using the pseudo-instruction entry with 
no arguments o The maximum number of arguments of entry is 3? < octal)? there 
is no limit on the number of arguments of exit*. 

The treatment of the pseudo-instruction noinput, and the function 
of the noinput bit in the TAC is slightly different from that in MACRO IIA S 
In an absolute program,, noirout replaces the normal input routine with an 
instruction tm 177*14* which will transfer control to the normal input routine 
if it is in storage. If the input routine interprets this instruction,, it 
will be read as an immediate start at location 177^0 which, of course, means 
it is ignored since this is the entry to the input routine • This instruc- 
tion is also supplied if the TAC is examined and bit 4 is off « In a relocat- 
able program the normal input routine is trn 17000 * a transfer to the MS 
Loader., Here noinput * either on the tape or via the TAC P deletes this trans- 



fer, This is principally useful in the preparation of library or other 
tapes with more than on© program o 

MACRO III will accept constants within constants up to eight 
levels deep* Examples 

add (llr (20) -add - (30 

will cause three different constants to be stored? 20 3C 6 and 

llr (20) - add - (30. Missing right parentheses are supplied at the 

terminating character (tab carriage return or comma),, 

MACRO III symbol punches are not compatible with MACRO IIA or 
with FLIT 1. They can be read by FLIT II , which will define the symbols 
according to the location of the program in memory c 

Various new error stops hare been added to MACRO II Io These are: 

us© Undefined symbol in an entry * -0 is substituted for 
the entry and the m& Loader will ignore it* 

usr Undefined symbol in th» count of a repeat o The symbol 
is taken as 0* This is the only undefined symbol 
alarm which can occur on Pass lo 

ir_ In general ft illegal relocation.. The third letter identi- 
fies type as in case of undefined symbol « The reloca- 
tion is taken as 0* 



ilr 



Illegal repeat o Negative count or repeat in the range 
of a repeat c The repeat is ignored o 



ads Multiply defined exit* A symbol in the arguments of\ 
e^t is defined with a conflicting value elsewhere in 
the program The attempt at redefinition is ignored* 

mdv Multiply defined variable.* An attempt to define a 
symbol as a variable failed because the symbol was 
previously defined as other than a variable * Th® 
attempt is ignoredo The error stop occurs on 
Rase 1 only* 

eld Constants location disagreement « The location of the 
pseudoobstruction constants differs on Bass 2 from 
that observed on Pass 1* This can happen if tapes 
are processed in the wrong order s if the location of 
constants was indefinite on Eass 1„ or if the PETB 
missed a word* Other causes may obtain also* The 
effect is that all preceding constants syllables hav® 
been assigned the wrong value* Assembly cannot be 
continued* 

vld Variables location disagreement* See eld * 

Thanks are due to Robert Wagner who assisted in writing and de- 
bugging MACHO III* 
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Macro III Program Examples 

Demonstration Main Program 

relocatable 
exit tst, opt 



sta. 



IP* 

get, 



llr (add tbl 
sir get 

llr (add (101001 
sir sw 

cla 

XX "" 

sto T 

llr • 

tra opt 

xx 

pno 

add t 

tra tst 

add get 

add (i 

sto get 

add (-add-tbl-2 

trn lp 

hit 

tra sta 



variables 
constants 



16000| 
tbl, 
xx«hlt 
start 



1 



| title 



defines tst«0+reloc, opt=i+reloc 
space before opt is optional 

| execution starts here 



defines variable ? 
• is relocated here 
call subroutine 



t may be in upper case 
call subroutine 



if tbl were relocatable, constant 
would have relocation count of -1 



in relocatable programs, use variables 
before constants lest next program be 
stored on top of variables 



address not significant 



Do not forget the carriage return after start. Note that this 
program has a bug in it— it needs llr » oel'gre tra tst . 



Binary Output Tape for Demonstration Main Program 

pie symbol r used here indicated the relocation constant which 
is determined by the loader at execution time. 

Address Word Relocation (if any) 



417000 



| transfer control to BBS Loader 



Ofr 

&-r 
3±z 
4+r 
5+r 
o+r 
7+r 
10*r| 

11+rJ 

124-r 

13*r 

14+r 

15+r 

±6*r 

17+r 

2Dfr 

2i+r 

224r 
23+r 
24*r 
25+r 



27*r 
304»r 
31+r 
32*2* 
33M 



600000 




-2 




100000 









2 


+r 


2 




77775 




100000 




-25 




25202 




502020 
712200 






300027 


+r 


100007 


+r 


300031 


+r 


100013 


+r 


700000 




630000 




26 


+r 


501252 




300011 


+r 


500001 


+r 


630000 
654020 




200026 


+r 


500000 


+r 


200007 


+r 


200032 


+r 


7 


+r 


504000 




200033 


+r 


400006 


+r 


630000 




500002 


4-r 


614573 




100027 




-33 




20000 




216000 




101001 




200030 


+r 


1 




561775 




356753 





program card identifier 

word count 

relocation word 

designates main program entry 

enters at relocated 2 

number names in transfer vector 

checksum 

relocatable block, origin relocatable 

last address 

relocation word 

flex tst) transfer vector, altered 

flex opt) by loader during patching 

sta, 



lp* 

get* 

t*26+r 

relocation word 

call subroutine opt 

sw, 

pno 



I call subroutine tst 



I relocation word 



I checksum 



new relocatable block, origin 27+r 
last address 
relocation word 
beginning of constants 



I add (101001 
I checksum 



i60Q0 absolute block, origin ±6000 

~3j6002 last address 

I600d 1 tbl, 
16001 2 
±6002| 3 

777773 I checksum 

200000 | start block denotes end of tape 
nothing is stored in register 26+r, which is reserved tor T. 



Demonstration Intermediate Level Subroutine 

reloc 
entry tst 
exit opt, dp t 

tsl, cla 

add (-2000 
ts2, ial 

dis 

ial 

add (1 

trn ts2 

ts3* lac 

llr . 

tra dpt 

add (101001 

prt 

cal 
tx, xx I beware of multiply defined ta@3 

tst 9 ial j entry point 

add (tra-llr+2 
sto tx 
tac 

trn ts4 
cyl 

tm tsl 
cyl 

trn ts3 
tra tx-i 

ts^, sir Tl 
lac 
llr . 
tra opt 
add (100101 
pno 

llr Tl 
tra tsl 



xx»hlt 



vari 

const 

start 



